perm filename LOGIN.BH[UP,DOC]8 blob sn#322018 filedate 1977-12-06 generic text, type C, neo UTF8
COMMENT āŠ—   VALID 00002 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	This writeup is taken from the Monitor Command Manual, which appears online
C00025 ENDMK
CāŠ—;
This writeup is taken from the Monitor Command Manual, which appears online
as MONCOM.BH[S,DOC].  This is Section 5.1 of that manual.


The LOGIN command is used to begin a session of using the computer.  It runs
the  LOGIN program,  which  provides several  optional services  as  well as
setting up the necessary system tables for your job.

The  LOGIN  command  may  be  abbreviated  L.   It  takes  one  argument,  a
project-programmer name.  Different characters used between the two parts of
the name are used for different options:

  PRJ,PRG  types all system messages and processes OPTION.TXT (see below)
  PRJ/PRG  types  system   messages  new   since  last   login,  processes
           OPTION.TXT
  PRJ.PRG  types no messages, ignores OPTION.TXT; for fast login
  PRJ%PRG  sets new password, as explained below, then acts like PRJ,PRG

Project 1 is the default project, and "/" is the default delimiter.  Hence,
"L FOO" is the same as "L 1/FOO" and "L .FOO" is the same as "L 1.FOO".

System messages are notices  for all users, sent  by the MAIL *  command and
stored in the  file NOTICE.TXT[2,2].  There  may also be  messages addressed
specifically to you.  The handling of your personal mail is explained below.

It  is possible  to set  a password  and file  protection codes  to restrict
access to a particular PPN.  If the PPN you specify to LOGIN has a password,
LOGIN types  Password= and  you must type  the correct  password to  log in.
Echoing of input  characters is turned off  so the password does  not print.
Passwords  may be  one to  six  letters or  digits followed  by  RETURN.  To
protect  files  from  unauthorized  access,  there  is  a   protection  code
associated with  each file.  The  code specifies the  access allowed  to the
file for its owner (i.e., a user logged in under the file's PPN),  for other
authorized AI  Lab users,  and for guest  users who  are logged  in remotely
(from the ARPA network, dial-up telephone lines, or campus  terminals).  You
can set the protection code for a file using the COPY program  (see Appendix
2).  However, you must use the  LOGIN program to set the protection  code of
your  file  directory  itself,  and the  default  protection  code  which is
assigned to new files created  in your directory if the program  writing the
file does not  specify a value  explicitly.  If you  use % as  the delimiter
between the project  and programmer names when  you log in, LOGIN  will give
you the opportunity to change your password, the file  directory protection,
and the default protection for new files.  The protection codes  are entered
as three-digit octal numbers, with the following meanings:

  Bit      Meaning in directory protection code

  400      password is for remote logins only (see below)
  200      unused
  100      owner may not write files
  040      local users may not change protection of files
  020      local users may not read directory or any files
  010      local users may not write any files
  004      guest users may not change protection of files
  002      guest users may not read directory or any files
  001      guest users may not write any files

  Bit      Meaning in file protection code

  400      don't dump this file (see DART, Appendix 5)
  200      delete protect (see COPY, Appendix 2)
  100      owner may not overwrite this file
  040      local users may not change protection of this file
  020      local users may not read this file
  010      local users may not overwrite this file
  004      guest users may not change protection of this file
  002      guest users may not read this file
  001      guest users may not overwrite this file

If  the 400  bit is  on in  the protection  code for  a file  directory, the
password associated  with that area  is used only  for logins from  a remote
site; no password will be required for local login on that PPN.   Except for
the special  NET,GUE guest account*,  remote login is  not allowed on  a PPN
which does  not have  a password; thus,  if you  want to be  able to  log in
remotely but do not want to have to type a password for local login, you can
set the 400 bit in your directory's protection code.

Users with access to local  terminals who sometimes need to log  in remotely
can set a  password (with %)  for their own PPNs;  remote users who  want to
establish accounts here should  communicate with Lester Earnest.   (Type the
command MAIL LES.)

Sometimes you may find the  system is in maintenance mode, which  means that
the monitor  is being debugged  and the system  is not available  for normal
use.   If you  try to  log in  at  such a  time you  will be  asked  for the
maintenance password.

The further  details of  LOGIN's operation  are controlled  by a  file named
OPTION.TXT which you  may have in  your directory.  If  there is one,  it is
searched for a line of the form

LOGIN:opt1,opt2,opt3;comments

where  opt1...optn are  the  desired options.   Spaces  may be  used  in the
obvious places.   Only the  first six letters  of an  option name  are read.
Upper or lower case is ok.  Several other programs use this OPTION.TXT file,
looking for their own option lines.

The LOGIN options are as follows:

  XMAIL    Inhibits mail notification if you were the last person to write
	   your mail file.
  XDIGEST  Always type the AP News digest, regardless of whether or not
	   you have NOMAIL set.
  NONOTE   Never type out system notices, no matter what delimiter you
	   used when logging in.  This is for people who have secondary
	   areas that they log in on and want OPTION.TXT files executed
	   but don't want to get system messages.
  SYSTAT   Type out the number of jobs logged in and how many running at
	   that instant.
  NOMAIL   Does not ask  any questions about  message files.  This  is for
           people  who like  to type  ahead while  LOGIN is  running.  The
           exact effect depends on what other options are used; see below.
  MESSAG   Types your mail without asking; see below.
  GRIPE    Types out new gripes just like new system messages.
  RUN=xxx  Where xxx is a file specification, runs the specified program.
	   The device defaults to SYS:.  This takes precedence over all
	   run-type options.
  LOGRUN   Runs the LOGRUN program, which executes monitor commands from a
           LOGRUN entry in OPTION.TXT; see below for details.  This is the
	   same thing as RUN=LOGRUN.
  INIT     Runs the file INIT.DMP in your directory after  login.  Doesn't
           work if you also have LOGRUN.  This is like RUN=DSK:INIT.
  BEEP     If you are at a display, enables the system feature of
	   automatic beeping whenever your job finishes doing something
	   that took more than 15 seconds of real time.  Like ESC Z.
  WHO      If you are at a display, starts a WHO line.  Like ESC W.
  AUDIO=n  Selects audio switch input channel n to your speaker if you are
           at a  display terminal.   "n" is  an octal  number.  "AUDIO=-n"
           inhibits telephone paging interrupts, like BREAK n U.
  DM       If you are not on a III or DD display, tells the system that
	   you are on a Datamedia (DM) display.
  DM=n     Just like DM option except that this specifies that your DM has
	   n lines (useful mostly on DM-simulating displays that provide
	   some number of display lines other than 24).
  FDM      Just like DM option if you are on a high-speed dialup line.
	   Ignored otherwise.
  FDM=n    Just like DM=n option if you are on a high-speed dialup line.
	   Ignored otherwise.
  DM128    Like DM option but also tells the system that your DM can
	   display the control characters (octal 1 to 37) when they are
	   output preceded by an ascii escape character (octal 33).
  DM128=n  Like DM=n and DM128 options combined.
  FDM128   Just like DM128 if you are on a high-speed dialup line.
	   Ignored otherwise.
  FDM128=n Just like DM128=n if you are on a high-speed dialup line.
	   Ignored otherwise.
  BOLD     If you are on a DM display, tells the system to display your
	   line editor in boldface, assuming your DM has bold and blinking
	   interchanged like all SU-AI DMs.  This is the default for DMs.
  NOBOLD   If you are on a DM display, tells the system not to display
	   your line editor in boldface/blinking (especially useful if
	   your DM does not have bold and blinking interchanged).  This
	   option should occur after the DM or DM128 option, if present.
  BS       If you are on a DM display, tells the system that your DM
	   displays the 177 character.
  NOBS     If you are on a DM display, tells the system that your DM
	   does not display the 177 character.  If you are in DM128
	   mode, the system will precede output of each 177 with an
	   033 to force the 177 to print.  Otherwise, the system will
	   convert echo or output of backspace (177) to appear as a
	   bold left-arrow.
  PORNO    Try it and see.  Doesn't work if you also have LOGRUN or INIT.
  DIGEST   Tells you if there is  a new Associated Press news  digest that
           came in after the  last time you logged  in and asks you  if it
           should type it out.
  QMAINT   Only type  maintenance forecast  if it  has changed  since last
           login.   Otherwise  the maintenance  forecast  is  always typed
           unless . is used as the PPN delimiter.
  ME       Tells you your fortune.
  COOKIE   Alternate fortune cookie selection.  See which you prefer.
  HIDE     Makes your Data Disc channel private, like ESC H.
  UNHIDE   Makes your Data Disc channel public, like BREAK H.
  WIDTH=n  If you are  at a Teletype, sets  the maximum number  of columns
           for TTY output to the decimal value n, which should  be between
           16 and 256.  Like TTY WIDTH n.
  FULL     If you  are at  a Teletype,  sets the  full character  set mode
           switch.  Like TTY FULL.
  NOFULL   If you are  at a Teletype, clears  the full character  set mode
           switch.  Like TTY NO FULL.
  TABS     If you are at a Teletype, clears the tab expand bit;  tabs will
           not be converted to spaces on output.  Like TTY TABS.
  NOTABS   If you are at a Teletype, sets the tab expand bit; tabs will be
           converted to spaces on output.  Like TTY NO TABS.
  FILL     If you are at a Teletype, sets the fill switch to  insert extra
           carriage returns on output to give the carriage time to get all
           the way back.  Like TTY FILL.
  NOFILL   If  you  are  at  a  Teletype,  clears  the  fill  switch  thus
           suppressing  insertion  of extra  carriage  returns  on output.
           Like TTY NO FILL.
  ECHO     If you  are at a  Teletype, tells the  monitor to send  back to
           your terminal the characters you type.  Like TTY ECHO.
  NOECHO   If you are at a Teletype, tells the monitor not to send back to
           your terminal the characters you type.  Like TTY NO ECHO.
  ARROW    If  you  are at  a  Teletype,  tells the  monitor  to  type out
           characters below octal  40 as uparrow-letter (e.g.,  ↑A) rather
           than  the character  itself except  for BEL  (7), TAB  (11), LF
           (12), VT (13), FF (14), and CR (15).  Like TTY ARROW.
  NOARROW  If  you  are at  a  Teletype,  tells the  monitor  to  type out
           characters below octal 40  as themselves instead of  as uparrow
           characters.  Like TTY NO ARROW.

If there is a message addressed to you, LOGIN normally types

Message for YOU last written by PRG using PROGRM on dd-mon-yy at hhmm
Read it now?

where YOU is your  programmer name, PRG is  the programmer name of  the last
user to  write anything  in your  message file,  PROGRM is  the name  of the
program used to do it, and dd-mon-yy  and hhmm are the date and time  it was
done.

If you type Y, the message file is printed, and you are allowed to delete it
(the whole file).  If you type N, the message file is not printed.   You can
also type R,  which will treat  your mail file  like a system  message file;
i.e.,  header lines  will not  be typed,  and, if  you used  a slash  in the
command, the  only messages typed  will be those  which came since  you last
logged in.  However, R may not find the recently received messages correctly
if your mail file is in E format.  If you type R, LOGIN does not ask  if you
want to delete the file.

If you have the MESSAG option but not the NOMAIL option, then  personal mail
is  always typed  out without  asking first.   If you  have both  MESSAG and
NOMAIL, the mail is typed but you are not given the chance to delete it.  If
you have NOMAIL alone, you get the Message for YOU...  line but not the mail
itself; many people use the  NOMAIL option for LOGIN and run  other programs
to read their mail.   See the file E.ALS[UP,DOC] on  the use of E as  a good
way to process your mail; remote users may prefer to use RCV--see page 105.

If you have DIGEST and NOMAIL, you are notified of a new A.P.  digest but it
is not typed out.  (RCV will also do this for you.)  It is also  possible to
get automatic  notification of  incoming news  stories on  particular topics
from the  NS program;  these messages  are treated  like personal  mail with
respect to MESSAG and NOMAIL.

The LOGRUN program  looks for a line  in your OPTION.TXT file  starting with
LOGRUN:.  It then takes that line, and all following lines until a semicolon
is seen, and makes them be executed as if you typed them in.  (The semicolon
is required.)


------
* At the present time the NET,GUE account has been discontinued,  because it
was  using too  much computer  time.  People  who are  not  authorized users
cannot log in remotely.  A  few monitor commands are allowed  without login,
as  mentioned  in the  individual  command descriptions.  The  special guest
account  capability  still  exists, however,  as  does  the  file protection
mechanism.  File transfers over the ARPA network initiated  remotely without
providing a password  are treated as guest  account use for  file protection
purposes.